home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 February / Macworld (1999-02).dmg / Shareware World / Maths & Science / YP Collisions 1.0 / User's Guide < prev    next >
Text File  |  1998-11-14  |  10KB  |  304 lines

  1. (For best results, this document should be viewed using SimpleText or Tex-Edit Plus.)
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. YP Collisions 1.0
  12.  
  13. Simulation of 2-D collisions.
  14.  
  15. Updated: November 1998
  16.  
  17. Author:  Yves Pelletier  
  18.          Email:  pelletier@kagi.com     or    ch865@freenet.carleton.ca
  19.          WWW:    http://www.kagi.com/pelletier
  20.  
  21. Price (Shareware):  $15 US
  22.  
  23. Keywords:  Physics teaching sciences dynamics momentum impulse collisions force motion
  24.  
  25. Program description:
  26. YP Collisions simulates a two-dimensional collision between two particles.  The user chooses the mass, the initial velocity (magnitude and direction), and the coefficient of restitution.  An animation shows the motions of the particles before and after the collision, and the following information is displayed:  final velocity of each particle, impulse of each particle, momentum (initial and final), percentage of conserved momentum, kinetic energy, percentage of conserved energy.  It is also possible to view the force exerted on each particle during the collision.
  27.  
  28. Required Hardware and Software:  YP Collisions runs on any Macintosh computer with Mac OS 7.0 or later.  It needs about 215 kb on your hard disk and 1,2 Mb of RAM.  The software runs on older Macs with 68000 processors (Mac Plus, Mac Classic), but simulations are slower.
  29.  
  30. Getting Started:
  31. When you launch YP Collisions, 2 windows are displayed on the screen: the animation window (in which the animated simulation will appear) and the Initial Conditions dialog. Select the "Start Animation" item in the "Animation" menu to start a simulation.  Use the "Results…" item in the "Animation" menu to get information about the simulated collision (percentage of conserved energy, etc.).  Other items from the "Animation" menu allow you to display the force exerted on the particles during the collision, and the direction of their motion.  In addition to the text fields allowing you to choose the mass and initial velocity of each particle, the Initial Conditions dialog has a scroll bar which you can use to change the coefficient of restitution.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51. Coefficient of restitution:
  52.  
  53. The coefficient of restitution can vary from 0 to 1, with 1 equivalent to an elastic collision (energy conserved at 100%) and 0 equivalent to a completely inelastic collision (the two bodies stick together after the collision).
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Using YP Collisions:
  60.  
  61. Note:  To help you explore all menus of the program, you can use balloon help (with the "?" menu, in the top right corner of the screen).
  62.  
  63. Menus:
  64.  
  65. "Apple" Menu:  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. Use this menu to
  73.       - open an item from the Apple Menu Folder
  74.       - read information about YP Collisions
  75.       - consult online help
  76.       - unlock your copy of the program.
  77.  
  78. •  "About YP Collisions..." item : When you select this item from the Apple menu, a dialog box showing information about the version number and copyright is displayed, as well as whether your copy of the software has been registered or not.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85. "Unlock" button:  This button is visible only if your copy of the software has not been personalized.  After receiving your personal unlocking code, click on this button to open another dialog box so that you may enter (or paste) your name and your unlocking code in the appropriate zones.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104. "Help & Info" Button:  This button gives you access to online help.  Information included in the help window is the same as that you are now reading.
  105.  
  106. "File" Menu:
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Use the "File Menu" to
  119.          - save the contents of the active window as a PICT file,
  120.          - close the active window,
  121.          - print the active window,
  122.          - quit the application YP Collisions.
  123.  
  124. "Save as PICT..." item:
  125.  
  126. When you select this item from the "File" menu, trajectories that are displayed in the animation window are saved as a PICT file, which can be open by any draw or paint program.
  127.  
  128. "Close Window" item:
  129.  
  130. When you select this item from the "File" menu, the program closes the active window.
  131.  
  132. "Page Setup..." item:
  133.  
  134. Use this item when you want to use a different paper size, or orientation.
  135.  
  136. "Print" item:
  137.  
  138. Use this item to print the content of the active window.  You can print trajectories and graphs.
  139.  
  140. "Quit" item:
  141.  
  142. Use this item from the file menu to quit the program "YP Collisions".
  143.  
  144. "Edit" Menu:
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152. The "Cut", "Paste" and Delete" items are available only when a dialog box in which you may enter text is active.
  153.  
  154. The "Copy" item is also available when the animation window (or the results window) is active, so you can easily copy the picture in the clipboard.
  155.  
  156. "Animation" Menu:
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169. Use this menu
  170.       - to start the animated simulation;
  171.                         - to show or hide the trajectory of the particles in the animation;
  172.       - to show or hide the force exerted on the particles during the collision;
  173.       - to show or hide the arrows indicating the direction of motion;
  174.       - to activate or deactivate slow motion;
  175.       - to display the Initial Conditions dialog, if it had been closed;
  176.       - to display the Results window, if it had been closed.
  177.       
  178.  
  179. "Initial Conditions…" item:
  180.  
  181. When you select this item from the "Animation" menu,  a dialog is displayed in which you can type the mass and initial velocity (magnitude and direction) for each particle.
  182.  
  183. The numerical values may be written in scientific notation if desired (ex:  +3.5E-4;  the exact syntax depends on the settings of your operating system, in the "Numbers" control panel). 
  184.  
  185. A scroll bar allows you to vary the coefficient of restitution from 0 to 1.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206. "Results…" Items:
  207.  
  208. When you select this item from the "Animation" menu, a window is displayed, in which you can find the following information:  
  209.  
  210. For each particle:  mass, initial velocity, final velocity, impulse.
  211.  
  212. For the whole system:  momentum (initial and final), percentage of conserved momentum (always 100%), kinetic energy (initial and final), percentage of conserved kinetic energy.
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236. "Help" Menu:
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246. YP Collisions supports Balloon Help.  Use this menu to show or hide help balloons, and to display online help. The information included in the help window is basically the same you are now reading.
  247.  
  248. Ordering information:   
  249. YP Collisions is shareware.  The unregistered version of YP Collisions may be freely distributed to allow anybody to try it before registering.  You are permitted to upload it to a BBS, distribute it on a CD-ROM, or give a copy to a friend. 
  250.  
  251. If you want to use YP Collisions on a regular basis, you must pay for a user license.  You will then receive an unlocking code that will permit you to personalize your copy of the program.  
  252.  
  253. The unregistered version have the following limitations:
  254.         •  the mention "This copy is for evaluation only." is permanently displayed in the main window.
  255.         •  an item from the "Animation" menu is not available (the unavailable animation is chosen randomly at startup among the 3 following items:  Show Force, Show Direction, Slow Motion).
  256.   •  the number of animations is limited to 12 (if you want to produce more animations, you must quit and restart the program).
  257.  
  258. Your unlocked version will have the following advantages:
  259.         •  the mention "This copy is for evaluation only." will never be displayed again in the main window.
  260.         •  all items of the "Animation" menu will be available.
  261.   •  there will be no limit to the number of animations.
  262.         •  in addition, you will be able to unlock all future updates of YP Collisions with the same unlocking code.
  263.  
  264. Methods of Payment:
  265.  
  266. You can pay your license to one of those two companies:  Kagi (located in the United States) and ShareIt! (located in Germany).
  267.  
  268. If you use Kagi, it is possible to pay by credit card (Visa, Master Card, American Express), by check or postal money order (in american dollars), with cash, or by "First Virtual".  For more information about registering YP Collisions with Kagi, please read the file "Registering with Kagi".
  269.  
  270. If you choose ShareIt!, you can pay by credit card (Visa, Mastercard/Eurocard, American Express and Diner's Club), by bank transfer/wire, by check, by eurocheque, or cash.  For more information about registering YP Collisions with ShareIt!, please read the file "Registering with ShareIt!".
  271.  
  272. Detailed Prices:
  273.   
  274. Single User License:  A $15.00 US registration fee will license one copy of YP Collisions for use on any one computer at any one time. For example, one copy may be used by any number of people and may be freely moved from one computer to another as long as there is no possibility of it being used simultaneously on more than one machine.
  275.  
  276. Site License:  A license covering all locations for your organization within a 160 kilometer radius of your site (100 miles), is available at the price of $200.00 US.
  277.  
  278. Technical Support:  
  279. If you have any comments or suggestions, please feel free to email me at pelletier@kagi.com  (or ch865@freenet.carleton.ca).
  280.  
  281. Other Physics Software From Yves Pelletier:
  282. Ray Optics:
  283.      YP Image constructs ray diagrams explaining
  284.         image formation by mirrors and thin lenses.
  285.      YP Reflection simulates the reflection of a 
  286.         laser ray on plane mirrors.
  287.      YP Refraction simulates the reflection of a 
  288.         laser ray in a prism.
  289. Classical Mechanics:
  290.      YP Projectiles is a projectile motion simulator.
  291.      YP Circular is a uniform circular motion and 
  292.          simple harmonic motion simulator.
  293. Mechanisms:
  294.      YP Slider Crank simulates the motion of a piston
  295.          activated by a slider crank mechanism.
  296.      YP Planetary Gear is a planetary gear train simulator.
  297.  
  298. To download the latest versions:  http://www.kagi.com/pelletier
  299.  
  300. © 1998 Yves Pelletier
  301. All rights reserved.
  302.  
  303. YP Collisions is provided “as-is”. Yves Pelletier hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose.  Yves Pelletier will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Yves Pelletier or an agent of his has been advised of the possibility of such damages.  In no event shall Yves Pelletier be liable for any damages, regardless of the form of the claim.  The person using the software bears all risk as to the quality and performance of the software.
  304.